home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1998 May / Software of the Month Club 1998 May.iso / pc / dos / dtp / sparkl43 / ruler.txt < prev    next >
Text File  |  1998-03-03  |  19KB  |  425 lines
  1.  
  2.               ---------------------------------------------------               
  3.                 -----------------------------------------------                 
  4.                   -------------------------------------------                   
  5.                     ---------------------------------------                     
  6.                       -----------------------------------                       
  7.                         -------------------------------                         
  8.                           ---------------------------                           
  9.                             -----------------------                             
  10.                               -------------------
  11.                                 ---------------                                 
  12.  
  13.  
  14.                     Ruler              by           Rob W. Smetana
  15.                                                     and Pro~Formance
  16.  
  17.                                 ---------------
  18.                               -------------------                               
  19.                             -----------------------                             
  20.                           ---------------------------
  21.                         -------------------------------                         
  22.                       -----------------------------------                       
  23.                     ---------------------------------------
  24.                   -------------------------------------------                   
  25.                 -----------------------------------------------                 
  26.               ---------------------------------------------------               
  27.  
  28.  
  29.           Ruler is a free, RAM-resident (TSR) ruler to show you:
  30.  
  31.                1) the row and column your cursor is on.
  32.  
  33.                2) the colors on the screen at that row and column
  34.                   (foreground, background and combined).
  35.  
  36.                3) which character is at that row and column.
  37.  
  38.                4) how wide text is, or how many rows and columns
  39.                   are in a rectangular area of the screen
  40.  
  41.  
  42.           NOTE:  This is an enhanced version of our original Ruler.
  43.           This new version now lets you MARK columns and rows to
  44.           determine the width or height of text, windows, menus, etc.
  45.                         
  46.  
  47.  
  48.                     Copyright (C) 1990-1998, Rob W. Smetana
  49.  
  50.                          All Rights Reserved Worldwide
  51.  
  52.  
  53.           Pro~Formance, P~F, Sparkle and P~F Presents are Trademarks
  54.                                of Rob W. Smetana
  55.  
  56.                                                                       
  57.  
  58.  
  59.      ===================================================================
  60.  
  61.                                 Introduction
  62.  
  63.      ===================================================================
  64.  
  65.      Included are:    Ruler.Exe & Ruler.Txt    (program and this manual)
  66.  
  67.  
  68.      Purpose:         A handy, RAM-resident utility you can call up from
  69.                       within other programs -OR- at the DOS prompt to:
  70.  
  71.                       1) display a "ruler" showing the row and column
  72.                          the cursor is on.
  73.  
  74.                       2) display the colors on the screen at that row/
  75.                          column (foreground, background and combined).
  76.  
  77.                       3) tell you which character is at that row/column.
  78.  
  79.                       4) let you mark areas of the screen to determine
  80.                          you how wide a line of text is, or how many
  81.                          rows and columns a rectangle consumes.
  82.  
  83.      Compatibility:   Ruler supports 25-, 43- or 50-line screens.  It's
  84.                       designed for 80-column, text-mode screens only.
  85.  
  86.      Uses:            We developed Ruler as a companion to many of our
  87.                       other programs.  For example:
  88.  
  89.                       * Our Sparkle batch file enhancer offers TWO
  90.                         options to turn text screens into scrolling bar
  91.                         menus!  Just display some text, then tell
  92.                         Sparkle where on your screen the menu-portion
  93.                         is and voila!  Ruler helps you determine on which
  94.                         row and column your menu begins and ends.
  95.  
  96.                       * Our P~F Presents presentation program (PFP) also
  97.                         offers scrolling bar menus.  As with Sparkle,
  98.                         Ruler helps you tell PFP which portion of the
  99.                         screen to turn into a menu.  And PFP also lets
  100.                         you "paint" the screen, and re-map colors.  Here
  101.                         again, just call up Ruler to tell you what
  102.                         colors are at various places.
  103.  
  104.                       * Programmers, batch file users, etc. often need
  105.                         to know how wide something is to, for example,
  106.                         properly center it on the screen (or prevent
  107.                         it from wrapping around to the next line).
  108.                         Ruler's "mark" option helps you determine width.
  109.  
  110.                         You can also use Ruler to determine where you
  111.                         should locate the cursor after, say, you've
  112.                         drawn a window or displayed a prompt.
  113.                                                                        
  114.  
  115.  
  116.          =============================================================
  117.  
  118.                              WARRANTY & DISCLAIMER
  119.  
  120.          =============================================================
  121.  
  122.          This product is provided "AS IS" without warranty of any kind.
  123.          The entire risk as to the results and performance of this pro-
  124.          duct is assumed by you.  We warrant only that any disks we sent
  125.          you are free from physical and workmanship defects under normal
  126.          use and service for a period of 90 days from the date shipped.
  127.  
  128.          Our entire liability, and your exclusive remedy, as to the disk,
  129.          shall be to, at our option, either (1) return the purchase price;
  130.          or, (2) replace disks which don't meet our limited warranty.
  131.           * Since you can try "user supported" versions of our programs
  132.             before ordering them, we offer no other warranty beyond that
  133.             stated here.  We'll gladly replace defective disks.  But no
  134.             refunds or credits can be issued.
  135.  
  136.          Neither Pro~Formance nor RWS & Associates, nor any of their of-
  137.          ficers or employees shall be held responsible for:  failures of
  138.          this product to satisfy any needs, damages due to using this
  139.          product, or any effects this program has on you, your business
  140.          or operations.
  141.  
  142.          This product, its manual and any supporting materials may be
  143.          modified or changed from time to time.  They may contain opera-
  144.          tional inaccuracies or typographical errors which may be cor-
  145.          rected by future versions, if any.  Registered users may be
  146.          notified of available updates.
  147.  
  148.  
  149.                                                                         
  150.  
  151.  
  152.         ===============================================================
  153.  
  154.                                 LIMITED LICENSE
  155.  
  156.          ==============================================================
  157.  
  158.          RULER is a copyrighted work.  It is NOT public domain software.
  159.  
  160.          However, you may use it free.  If you'd like to contribute some-
  161.          thing, see the last few pages where we've described some of our
  162.          other programs.  The last page has a registration form.
  163.  
  164.          ===============================================================
  165.  
  166.              Ruler MAY NOT be distributed with any other product or
  167.              service without a prior license arrangement.
  168.  
  169.          ===============================================================
  170.  
  171.                                DISTRIBUTING Ruler
  172.  
  173.          ===============================================================
  174.  
  175.          Bulletin board Sysops, clubs and shareware distributors may
  176.          copy and distribute shareware versions of Ruler, provided:
  177.  
  178.          *** Your company name IS NOT:   California Freeware         ***
  179.                                            American Freeware
  180.                                                  US Freeware
  181.  
  182.              or any other firm, group or association which uses terms
  183.              like "free software," "freeware" or "free" to misrepresent
  184.              "user-supported" software.
  185.  
  186.          (1) It is distributed in completely unmodified form.
  187.  
  188.          (2) You charge nothing other than a "disk distrubution fee"
  189.              of up to $8.00 to cover distribution and handling.
  190.  
  191.          (3) You state YOUR fee is NOT payment or registration for
  192.              OUR software.
  193.  
  194.          (4) You clearly encourage registration by stating that con-
  195.              inued use justifies sending contributions to the developer.
  196.  
  197.          (5) You include all these files intact:  Ruler.Exe, Ruler.Txt
  198.  
  199.                                                                           
  200.  
  201.  
  202.      ==================================================================
  203.  
  204.                                 Using Ruler
  205.  
  206.      ==================================================================
  207.  
  208.      To run Ruler:      Type   Ruler <enter>   (It uses about 8k of RAM.)
  209.  
  210.      To unload it:      Type   Ruler  /u  <enter>
  211.  
  212.      To call it up:     Press  Ctrl-Esc  (sorry, at this time there's
  213.                                           no way to change hot keys)
  214.  
  215.      NOTE:  If you use QEMM, 386Max or other memory-management software,
  216.      you can usually load Ruler "high" (ie., into high memory) so that
  217.      it consumes NO DOS memory.
  218.  
  219.      ==================================================================
  220.  
  221.      Run Ruler then press Ctrl-Esc to call it up.  Press:
  222.  
  223.  
  224.          Left/Right   cursor keys to move the CURSOR Left/Right
  225.  
  226.          Home/End     to move the CURSOR to the Left or Right side
  227.                       of the screen (column 1 or 80)
  228.  
  229.          Up/Down      cursor keys to move the RULER up/down
  230.  
  231.          PgUp/PgDn    to move the RULER to the top/bottom of your screen.
  232.  
  233.          M or Enter   to begin marking the width or height of something.
  234.                       To turn OFF marking, press M or Enter again.
  235.  
  236.  
  237.      As you press cursor pad keys you'll see numbers in the ruler change:
  238.  
  239.      * Ruler shows which row and column you're on.
  240.  
  241.      * It also shows 3 Color numbers:  the Foreground (FG) and Back-
  242.        ground (BG) color at the row/column your cursor is at, plus
  243.        the combination of the 2.
  244.  
  245.        - This can be useful to find when colors change, or when colors
  246.          aren't what you expected them to be.
  247.  
  248.        - The combined color number is useful with our Sparkle program,
  249.          which needs a combined foreground/background color for printing
  250.          text, windows, Big! Font messages, etc.
  251.  
  252.      * Finally, it displays the ASCII code of the character beneath the
  253.        cursor.  For example, 32 = Space, 65 = A, 97 = a, etc.  Consult
  254.        your DOS or BASIC manual for a list of all 256 ASCII characters
  255.        and their numbers.
  256.                                                                        
  257.  
  258.  
  259.      Determining the Width or Height of Something
  260.      ============================================
  261.  
  262.      Once you press Ctrl-Esc to call up Ruler, you can press "M" (or
  263.      Enter) to "turn on" [M]arking mode.  When you do:
  264.  
  265.      * Ruler will reverse the color of its 2nd line to let you know
  266.        you're in "mark" mode.
  267.  
  268.      * Ruler will reset both Row and Column to 1 -- indicating you're
  269.        at the first Row and Column of whatever you're marking.
  270.  
  271.      * As you move the cursor, the numbers beside Row and Column will
  272.        change telling you how wide (# of Columns) or tall (# of Rows)
  273.        something is.
  274.  
  275.  
  276.        Note:  You may move in ANY direction.  Ruler shows the absolute
  277.        number of rows and columns you've travelled since you turned
  278.        "mark" mode on.  That means you need NOT move to the top left
  279.        corner of something to begin marking.
  280.  
  281.  
  282.      To turn OFF marking mode, press "M" or Enter again.  To mark
  283.      something else, move the cursor to one corner of what you want to
  284.      mark, then quickly press "M" twice -- once to turn it off, then
  285.      again to turn it back on again.
  286.  
  287.      Marking mode REMAINS on or off between calls to Ruler.  So if
  288.      you're in marking mode, press Escape to put the ruler away, then
  289.      press Ctrl-Esc again, marking mode will still be on.  Just press
  290.      M or Enter to turn it off.
  291.  
  292.  
  293.      Uses
  294.      ====
  295.  
  296.      Mark mode has many uses.  For example:
  297.  
  298.      * To print text centered on the screen, you need to know how wide
  299.        text is, and then locate the cursor (or pad it with spaces) using
  300.        the formula:   40 - (Width / 2).
  301.  
  302.      * Some programs need to be told how wide or tall something is (eg.,
  303.        draw a window 30 columns wide and 15 rows high starting at column
  304.        25, row 5).
  305.  
  306.      * Programmers or batch file users often need to know how wide
  307.        things are.
  308.  
  309.  
  310.                                                                      
  311.  
  312.                                     To Order
  313.         ===============================================================
  314.  
  315.         Because we offer so many programs, our order form has 2 pages.
  316.  
  317.          * THIS PAGE lists our programs and the per-copy cost of each.
  318.            Please read CATALOG.TXT for a description of each program.
  319.  
  320.          * THE NEXT PAGE is the actual order form.
  321.  
  322.            - On the next page, fill in the name of each program you're
  323.              ordering.  PLEASE BE CAREFUL here and use the names listed
  324.              below.  If we're not sure which program you're ordering,
  325.              we may have to return you're order.
  326.  
  327.            - If ordering by Visa or MasterCard, fill in the section
  328.              for credit card orders.  BE SURE TO SIGN it.
  329.  
  330.           Program Name                                          Per Copy
  331.           ==============================================================
  332.           Multi-Print      $19 if ordered w/ ANY other program  $19/$29
  333.  
  334.           Font Pak "Pro"   Programmer's Fonts & Mouse Shapes      $49
  335.  
  336.           Font Pak "DOS"   Hundreds of DOS text-mode fonts        $29
  337.  
  338.           PDT              The Pro~Formance Data Tool            $139
  339.           PDT Tool Kit     (FREE when you order PDT!)             $39
  340.  
  341.           inform-Z         Professional Forms Design/Database     $29
  342.  
  343.           Mail Call        With MC Express                        $29
  344.  
  345.           Pro~Scribe & PS Express                                 $29
  346.  
  347.           P~F Presents     Professional Version                   $79
  348.  
  349.           P-Screen Professional                                   $49
  350.               "    Plus                                           $29
  351.  
  352.           Pro~Stamp        Stamp Collection Manager               $29
  353.  
  354.           Ram-Man          RAM-resident Text File Browser         $19
  355.  
  356.           Sparkle AND Menu Magic                                  $29
  357.  
  358.           The Survey Catalyst                                    $395
  359.  
  360.         =================================================================
  361.         PACKAGE DISCOUNTS  Call about quantity discounts & site licenses.
  362.         =================================================================
  363.           THE WORKS!  One of each program (except The Catalyst)  $299
  364.           Sparkle -AND- P-Screen                                  $49
  365.           inform-Z -AND- Mail Call                                $49
  366.           P-Screen Pro -AND- P~F Presents (Pro versions of both)  $99  
  367.  
  368.  
  369.      ============================= TO  ORDER  =============================
  370.  
  371.      For FASTEST delivery of your programs, CALL with a Visa/MC card number.
  372.  
  373.  
  374.      F __________________________________________   M    Rob W. Smetana
  375.                                                          Pro~Formance
  376.      R __________________________________________   A T  132 Alpine Terrace
  377.                                                          San Francisco, CA
  378.      O __________________________________________   I O      94117
  379.                                                          (415) 863-0530
  380.      M __________________________________________   L
  381.                                                          Make checks payable
  382.      Phone (     ) ______-________ Date ___/___/___      to:  Rob W. Smetana
  383.  
  384.      =======================================================================
  385.                            For Visa or MasterCard Orders
  386.      =======================================================================
  387.  
  388.      Credit Card Number:  ________________________________  Expires: ___|___
  389.  
  390.      Signature (Required for credit card orders): __________________________
  391.  
  392.      Be sure your name at the top matches how it appears on your credit card.
  393.  
  394.      =============================================================== ruler =
  395.  
  396.      Name of Program or "Package"         # of Copies  Price/Copy    Total
  397.  
  398.      =======================================================================
  399.  
  400.      Multi-Print ($19 if ordered /w other pgm) _____  x  $19/$29 =  $_______
  401.  
  402.      _____________________________________  ________  x  ______  =  $_______
  403.  
  404.      _____________________________________  ________  x  ______  =  $_______
  405.  
  406.      =======================================================================
  407.  
  408.      Shipping & Handling: Total Number
  409.      of Programs (and Copies)  ----->>   _____@ $4/copy             $ ______
  410.      =============================+=========================================
  411.                                   |                     Subtotal  $ ________
  412.       INTERNATIONAL ORDERS: : :   |
  413.                                   |    CA. residents, add 8.5% tax $ _______
  414.       * US funds only please.     +-----------------------+-----------------
  415.       * Money order, check drawn a                        |
  416.         US bank, or VISA/MasterCard                       |TOTAL  $ ________
  417.      =====================================================+=================
  418.  
  419.      WHERE did you got your copy of our program? _________________________
  420.      This helps us learn the best way to get new programs to you.  And feel
  421.      free to write comments and suggestions on the other side.   Thank you.
  422.  
  423.  
  424.  
  425.